home *** CD-ROM | disk | FTP | other *** search
/ Network Support Library / RoseWare - Network Support Library.iso / mac / mipxgw.exe / MACIPXGW.TXT next >
Text File  |  1993-09-14  |  30KB  |  695 lines
  1. "Installing and Administering an IPX Gateway for MacIPX-Based Applications"
  2. Copyright (c) 1993 by Novell, Inc. All rights reserved worldwide.
  3.  
  4.  
  5. WELCOME
  6.  
  7. Welcome to the IPX(tm) gateway software, which Novell(R) provides to support 
  8. networked applications that use the MacIPX(tm) transports. This README file 
  9. includes information about the IPX gateway software. The IPX gateway is LAN 
  10. driver software, and the IPX gateway can be used on computers running the 
  11. Novell NetWare(R) operating system, version 3.11 or later, or the NetWare 
  12. Multiprotocol Router(tm) software (MPR), version 2.0 or later. You may want to 
  13. print this file for future reference.
  14.  
  15. You need the IPX gateway software *only* under specific circumstances: you are 
  16. using a MacIPX-based application on network segments that use only the 
  17. AppleTalk(R) transport protocol to connect Macintosh(R) workstations to the 
  18. network. Such "AppleTalk-only" segments result from technological or 
  19. administrative conditions; the segment may use LocalTalk or another cable 
  20. served by a third-party AppleTalk router, or a network administrator may want 
  21. to designate a segment for AppleTalk traffic only.
  22.  
  23. If you use Ethernet or Token Ring segments to connect your Macintosh 
  24. workstations to an IPX network and if you permit IPX traffic on those 
  25. segments, then you do *not* need this README file or the IPX gateway software.
  26.  
  27.  
  28. INTRODUCTION
  29.  
  30. Because Macintosh users in your organization use networked applications that 
  31. rely on MacIPX transports, you may possibly need to use this IPX gateway 
  32. software to support your Macintosh users.
  33.  
  34. This README file explains these topics:
  35.  
  36. (1) MacIPX driver software and the IPX gateway software
  37. (2) How to install the IPX gateway on a NetWare server or NetWare MPR
  38. (3) How to load (run) the IPX gateway on a NetWare server or NetWare MPR
  39. (4) How to bind the IPX gateway to a specific interface
  40. (5) How to configure the IPX gateway to serve specific networks
  41. (6) How to advertise the IPX gateway service on the network
  42. (7) How to access and use IPX gateway statistics
  43. (8) How to interpret IPX gateway error messages
  44. (9) Some fine points about administering an IPX gateway
  45.  
  46. Of these nine topics, the most fundamental are the second, third, fourth, and 
  47. fifth. The initial topic provides background information, and the remaining 
  48. topics enable you to make more sophisticated use of the IPX gateway software.
  49.  
  50.  
  51. MacIPX AND THE IPX GATEWAY
  52.  
  53.     *******************************************************************
  54.     * PLEASE NOTE: MacIPX software provides support for IPX transport *
  55.     * protocols. It does not enable Macintosh users connected to the  *
  56.     * IPX network to log in to a NetWare server or to print documents *
  57.     * on NetWare printers. Users and developers must rely on other    *
  58.     * software to support NetWare file and print services.            *
  59.     *******************************************************************
  60.  
  61. The MacIPX driver software from Novell enables a Macintosh workstation to use 
  62. the IPX transport protocols to send and receive data on any network cable. 
  63. Because IPX is the native transport protocol for NetWare LANs, MacIPX enables 
  64. a Macintosh workstation to partake of a NetWare LAN's many resources. Figure 1 
  65. below illustrates what MacIPX does.
  66.  
  67. Figure 1: MacIPX applications send IPX data from Macintosh workstations onto 
  68. an IPX network.
  69.  
  70.  
  71.  -----------                    ---------                    -----------
  72. / Macintosh \     IPX Data     / NetWare \     IPX Data     / Macintosh \
  73. |system with| <--------------> | server  | <--------------> |system with|
  74. \  MacIPX   /     on cable     \ or MPR  /     on cable     \  MacIPX   /
  75.  -----------    (Enet/TRing)    ---------    (Enet/TRing)    -----------
  76.  
  77.                 (No AppleTalk Protocol on either segment)
  78.  
  79.  
  80. If *all* the Macintosh workstations running MacIPX-based applications are 
  81. connected to an Ethernet or Token Ring cable, then you have no need for the 
  82. IPX gateway.
  83.  
  84. You need the IPX gateway software *only* if some or all Macintosh workstations 
  85. are connected to an IPX network by means of an AppleTalk-only cable, such as a 
  86. LocalTalk cable or other cable served by a third-party AppleTalk routing 
  87. device, as shown in Figure 2.
  88.  
  89. Figure 2: IPX gateway accepts IPX data (with AppleTalk encapsulation) from 
  90. Macintosh workstations on an AppleTalk-only network cable and decapsulates the 
  91. IPX data for routing in an IPX network.
  92.  
  93.  
  94.  -----------    Encapsulated    ----------------                -----------
  95. / Macintosh \     IPX Data     / NetWare server \   IPX Data   / Macintosh \
  96. |system with| <--------------> | or MPR with    | <----------> |system with|
  97. \  MacIPX   /     on cable     | IPX gateway    |   on cable   \  MacIPX   /
  98.  -----------  (AppleTalk-only) \ software       / (Enet/TRing)  -----------
  99.                                 ----------------
  100.                                             (No AppleTalk on this segment)                  
  101.  
  102.  
  103. In this case, each Macintosh user connected to an AppleTalk-only cable must 
  104. configure the MacIPX Control Panel to use the AppleTalk interface. 
  105. Accordingly, you must install the IPX gateway on the NetWare server or NetWare 
  106. Multiprotocol Router, as indicated in Figure 2. Once you have installed the 
  107. IPX gateway, the MacIPX driver can discover the IPX gateway on the network, or 
  108. the Macintosh user can specify the IPX gateway explicitly as part of his or 
  109. her MacIPX configuration.
  110.  
  111. When the IPX gateway is installed on a NetWare server or NetWare Multiprotocol 
  112. Router, the IPX data destined for and transmitted by a Macintosh system 
  113. connected to an AppleTalk-only cable has the proper AppleTalk encapsulation; 
  114. the MacIPX driver software at the Macintosh supplies this encapsulation. When 
  115. the IPX data is destined for or transmitted by a Macintosh system connected to 
  116. Ethernet or Token Ring, the MacIPX driver adds no AppleTalk encapsulation.
  117.  
  118. The AppleTalk encapsulation and decapsulation occurs automatically when the 
  119. IPX gateway and the Macintosh workstations on an AppleTalk-only network cable 
  120. are properly configured. The process is not complex and assures smooth 
  121. operations for your network.
  122.  
  123. NOTE: In situations where the IPX gateway software is required, you also need 
  124. the APPLETLK.NLM software running on the NetWare server or NetWare 
  125. Multiprotocol Router. The APPLETLK.NLM module is provided in the following 
  126. ways:
  127.  
  128. 1. With NetWare 4.0 network operating system
  129. 2. With NetWare 3.11 UpDate software and later versions of NetWare 3.x
  130. 3. With NetWare for Macintosh software
  131. 4. With NetWare Multiprotocol Router 2.0 or later
  132. 5. Via downloading from various online services, including Novell's 
  133. NetWire(sm) forum on CompuServe(R)
  134.  
  135. The APPLETLK.NLM module must be installed and configured according to 
  136. instructions that accompany any of the Novell products in which it is 
  137. included.
  138.  
  139.  
  140. INSTALLING THE IPX GATEWAY
  141.  
  142. To install the IPX gateway on the NetWare server or NetWare Multiprotocol 
  143. Router, copy the file MACIPXGW.LAN from the distribution diskette to the 
  144. SYS:SYSTEM directory of the system. For example, if you have mapped the SYS 
  145. volume of your server or router to drive F of a DR-DOS or MS_DOS PC, place the 
  146. distribution diskette into drive A of the PC, and execute this command:
  147.  
  148.   COPY A:MACIPXGW.LAN F:\SYSTEM
  149.  
  150. Make sure that the SYSTEM directory is in the server's or router's search 
  151. path.
  152.  
  153. In addition, the MACIPXGW.MSG and MACIPXGW.MDB files provided with the IPX 
  154. gateway must be copied over to the SYS:SYSTEM directory on NetWare 4.0 
  155. servers. These files are *not* required for NetWare 3.x.
  156.  
  157.  
  158. LOADING THE IPX GATEWAY MODULE
  159.  
  160. After installing the IPX gateway LAN driver, execute the following LOAD 
  161. command at the server or router prompt to launch the IPX gateway software:
  162.  
  163.   LOAD MACIPXGW
  164.  
  165. To specify a distinctive name for the IPX gateway when you load it, you can 
  166. execute a command like this:
  167.  
  168.   LOAD MACIPXGW GATEWAY_NAME="AppleTalk-IPX Gateway"
  169.  
  170. Macintosh users will see this name when they configure MacIPX at their 
  171. workstations.
  172.  
  173. You can also include this command in the NetWare server's or NetWare 
  174. Multiprotocol Router's AUTOEXEC.NCF file. General information about the LOAD 
  175. command can be found in the "Utilities Reference" manual for the NetWare 
  176. operating system or the NetWare Multiprotocol Router. See "Options When 
  177. Loading the IPX Gateway," later in this file, for additional functions you can 
  178. perform when loading the IPX gateway software.
  179.  
  180.  
  181. BINDING THE IPX GATEWAY TO THE IPX NETWORK
  182.  
  183. After loading the gateway, you should bind the IPX gateway to the IPX network, 
  184. using this command:
  185.  
  186.   BIND IPX TO MACIPXGW NET=<net_number>
  187.  
  188. The <net_number> in this command must be a unique network number; think of 
  189. this as the "MacIPX network number."
  190.  
  191. This command effectively binds IPX to the gateway itself. The command can be 
  192. executed at the server or router prompt or can be included in the server's or 
  193. router's AUTOEXEC.NCF file, after the LOAD MACIPXGW command.
  194.  
  195. To disconnect the IPX gateway from the IPX network, you can issue this 
  196. command:
  197.  
  198.   UNBIND IPX FROM MACIPXGW
  199.  
  200. If the IPX gateway is not connected to the IPX network with a bind command as 
  201. described above, the IPX gateway will not appear in the IPX Gateway list in 
  202. the MacIPX Control Panel, and Macintosh users will not be able to select it as 
  203. part of configuring MacIPX at their workstations.
  204.  
  205. General information about the BIND and UNBIND commands can be found in the 
  206. NetWare operating system "Utilities Reference" manual.
  207.  
  208.  
  209. -- Options When Loading the IPX Gateway --
  210.  
  211. The LOAD MACIPXGW command has three optional parameters, specified in this 
  212. syntax diagram:
  213.  
  214.   LOAD MACIPX [GATEWAY_NAME="<name>"] [SHOW=yes] [UNICAST_THRESHOLD=<number>]
  215.  
  216. Use any of these optional parameters -- none is required, nor does any one 
  217. require another -- to achieve the effects described below.
  218.  
  219. The GATEWAY_NAME parameter specifies the name for the IPX gateway, as 
  220. illustrated above. You may choose any name you like; choose a name that users 
  221. will recognize easily, and don't forget to enclose the <name> in double 
  222. quotation marks. This <name> is the NBP (Name Binding Protocol) object name 
  223. used for advertising the IPX gateway's name on the AppleTalk network. This 
  224. name appears in the dialog in which the Macintosh user selects an IPX gateway. 
  225. If the LOAD MACIPXGW command lacks this parameter, the gateway name is set by 
  226. default to the name of the server or router where the gateway is installed.
  227.  
  228. The SHOW parameter displays information about the configuration and operation 
  229. of the IPX gateway *after* MACIPXGW.LAN is already loaded, not *while* it is 
  230. being loaded. See "Viewing Information about the IPX Gateway," further below 
  231. in this file, for more information about this parameter.
  232.  
  233. For example, to view information about an IPX gateway already loaded at the 
  234. server or router, you can issue this command at the NetWare prompt:
  235.  
  236.   LOAD MACIPXGW SHOW=YES
  237.  
  238. This command does not attempt to reload the IPX gateway but instead displays 
  239. information about the IPX gateway and the AppleTalk networks that it serves, 
  240. as in this example:
  241.  
  242.   MACIPXGW:
  243.     Unicast threshold set at 1.
  244.     AppleTalk nets this gateway is configured to serve:
  245.     10-10      100      1500-1502      2001-2005
  246.  
  247.   AppleTalk nodes registered for IPX broadcasts:
  248.     IPX node:  0xffffffffffff
  249.       Socket:  0x452
  250.                10.128    1501.138      1502.168
  251.       Socket:  0x453
  252.                10.128
  253.  
  254. This information includes these items:
  255.  
  256. * The value for the unicast threshold, described in the next section
  257.  
  258. * The network numbers of all AppleTalk networks served by this gateway
  259.  
  260. * All AppleTalk nodes (network.node) currently registered with the IPX gateway 
  261. for broadcasts, identified by IPX socket
  262.  
  263. The UNICAST_THRESHOLD parameter determines how to deliver IPX broadcast 
  264. messages to MacIPX clients that use the IPX gateway. Depending on the <number> 
  265. argument, the IPX gateway delivers packets to MacIPX clients either by sending 
  266. broadcasts to the AppleTalk networks to which the clients are connected or by 
  267. sending directed packets to the MacIPX clients themselves.
  268.  
  269. How you configure the IPX gateway determines how IPX broadcast messages are 
  270. delivered to MacIPX clients that use the IPX gateway. IPX broadcast messages 
  271. can be delivered either as single broadcasts on the AppleTalk networks or as 
  272. individual packets directed to explicitly registered MacIPX clients.
  273.  
  274. As mentioned in the previous section, the UNICAST_THRESHOLD parameter takes a 
  275. numeric argument. This number, specified with the LOAD MACIPXGW command, 
  276. represents a maximum number of MacIPX clients registered on an AppleTalk 
  277. network at an IPX socket to which directed packets should be delivered. If an 
  278. AppleTalk network includes more MacIPX clients than the number given with the 
  279. UNICAST_THRESHOLD parameter, then the IPX gateway delivers an IPX broadcast 
  280. encapsulated within an AppleTalk broadcast packet to all the AppleTalk 
  281. networks that constitute the IPX network. Thus the packet is received by all 
  282. Macintosh systems on those AppleTalk networks, including those running MacIPX. 
  283. Macintosh systems not running MacIPX will not understand those broadcast 
  284. packets and should drop them. This parameter is designed to control broadcast 
  285. network traffic. For more information, see "Tips about Performance and Network 
  286. Traffic," further below in this file.
  287.  
  288. The default value for the UNICAST_THRESHOLD parameter is 1. You can specify 
  289. from 1 to 4294967295 (unsigned four-byte integer) as the value for this 
  290. parameter.
  291.  
  292.  
  293. -- Configuring the IPX Gateway to Serve Specific AppleTalk Networks --
  294.  
  295. You can configure the IPX gateway to serve a selection of available AppleTalk 
  296. networks or all AppleTalk networks. By default, all AppleTalk networks are 
  297. served, and you need not take any special action. To restrict the IPX 
  298. gateway's service to specific AppleTalk networks, you must create a 
  299. configuration file called MACIPXGW.DAT in the SYS:SYSTEM directory on the 
  300. server or router. This file contains lines using this syntax:
  301.  
  302.   [EXCLUDE|INCLUDE]
  303.   <net_number>[-<net_number>]
  304.   {<net_number>[-<net_number>]}
  305.  
  306. The first line can provide an optional keyword that specifies the mode of 
  307. inclusion; EXCLUDE directs the gateway to serve *all* AppleTalk networks 
  308. *except* for those specific networks whose numbers are listed below, and 
  309. INCLUDE instructs the gateway to serve *only* those specific network numbers 
  310. listed below. If no keyword appears, INCLUDE is the default mode. The file 
  311. *must* include one network number or range and, as indicated by the curly 
  312. braces in the syntax example, may optionally include more network numbers or 
  313. ranges, with each network specified on its own line.
  314.  
  315. For example, consider a MACIPXGW.DAT file containing this command:
  316.  
  317.   EXCLUDE
  318.   10-10
  319.   100
  320.  
  321. This instructs the gateway to serve *all* AppleTalk networks *except for* 10-
  322. 10 and 100. Alternatively, consider this MACIPXGW.DAT file:
  323.  
  324.   INCLUDE
  325.   10-10
  326.   100
  327.  
  328. This instructs the gateway to serve *only* AppleTalk networks 10-10 and 100, 
  329. excluding all others.
  330.  
  331. If no MACIPXGW.DAT file is found in SYS:SYSTEM, then the IPX gateway serves 
  332. all AppleTalk networks.
  333.  
  334. NOTE: The network numbers in these examples are AppleTalk network numbers, not 
  335. IPX network numbers. This reflects the situation, referred to above, in which 
  336. the APPLETLK.NLM software has already been installed and configured and 
  337. already serves an AppleTalk-only segment of the network.
  338.  
  339.  
  340. -- Advertising the IPX Gateway Service on the Network --
  341.  
  342. After it is loaded, the IPX gateway advertises itself on the AppleTalk network 
  343. by registering with AppleTalk's Name Binding Protocol (NBP). Following this 
  344. registration with NBP, the IPX gateway displays a notice like this one at the 
  345. server or router console, including the NBP name and AppleTalk address of the 
  346. advertised service:
  347.  
  348.   MACIPXGW:
  349.     Gateway registered with NBP as
  350.     TITAN:IPX Gateway@TwilightZone at
  351.     address 1428.28.28
  352.  
  353. If you unload MACIPXGW.LAN, the IPX gateway ceases to advertise itself because 
  354. it is no longer registered with NBP, and after this occurs, the gateway 
  355. displays a message like this one:
  356.  
  357.   MACIPXGW:
  358.     Gateway TITAN:IPX Gateway@TwilightZone
  359.     de-registered from NBP.
  360.  
  361.  
  362. IPX GATEWAY STATISTICS
  363.  
  364. You can use the MONITOR NLM to review certain statistics about the IPX 
  365. gateway. Here is a typical procedure:
  366.  
  367. 1) Start the MONITOR NLM at the server or router:
  368.  
  369.    LOAD MONITOR
  370.  
  371. 2) From the main menu, select the LAN Information option, and then the 
  372. MACIPXGW option.
  373.  
  374. The resulting display includes a General Statistics section that enumerates 
  375. IPX packets that the IPX protocol stack has sent to and received from the IPX 
  376. gateway.
  377.  
  378. 3) Scroll down to see the Custom Statistics section to see information on 
  379. gateway operation, which includes these categories:
  380.  
  381. 1. Received Tickle Packets
  382. 2. IPX Broadcast Requests From IPX Stack
  383. 3. DDP Packets Broadcasted For IPX Broadcasts
  384. 4. DDP Packets Unicasted For IPX Broadcasts
  385. 5. IPX Broadcast Requests From MacIPX Clients
  386. 6. Received DDP Packets With Unknown Options
  387. 7. Received DDP Packets With Wrong Type
  388. 8. Received Service Requests
  389. 9. Transmitted Service Grants
  390. 10. Transmitted Service Refusals
  391. 11. Memory Allocation Failure
  392.  
  393. Items 6 and 7 are of particular interest to the IPX gateway. Item 6 enumerates 
  394. packets received from the AppleTalk network that are addressed to the 
  395. encapsulation socket and include unrecognized de-multiplexing options. Item 7 
  396. enumerates packets received from the AppleTalk network that are addressed to 
  397. the encapsulation socket for which the packet type was not the encapsulation 
  398. type.
  399.  
  400.  
  401. IPX GATEWAY MESSAGES
  402.  
  403. The IPX gateway generates these messages at the server or router console in 
  404. the course of its operations:
  405.  
  406. 1. MACIPXGW: Gateway registered with NBP as NBP entity at address 
  407. <AppleTalk_net>.<AppleTalk_node>.<AppleTalk_socket>.
  408.  
  409. This message appears when the gateway has successfully registered with NBP.
  410.  
  411. 2. MACIPXGW: Gateway <NBP_entity> de-registered from NBP.
  412.  
  413. This message appears when the gateway has successfully de-registered itself 
  414. from NBP; this occurs after you unload the gateway.
  415.  
  416. 3. MACIPXGW: Unloading MACIPXGW.LAN because of initialization failure.
  417.  
  418. Check to see whether the resource utilization of the server or router is at 
  419. reasonable level. Check if APPLETLK.NLM already loaded, and then try reloading 
  420. again.
  421.  
  422. 4. MACIPXGW: Unknown option <number> in received encapsulated packet.
  423.  
  424. The gateway received an AppleTalk packet addressed to the encapsulation 
  425. socket, but an unknown option was found in the packet. This is probably caused 
  426. by a misbehaving client.
  427.  
  428. Take a packet trace and try to locate the packet originator.
  429.  
  430. 5. MACIPXGW: Failed to open socket.
  431.  
  432. Failed to open a DDP socket.
  433.  
  434. Check for AppleTalk socket availability.
  435.  
  436. 6. MACIPXGW: Failed to find zone for gateway.
  437.  
  438. The gateway is unable to find the AppleTalk zone in which the IPX gateway 
  439. should be registered.
  440.  
  441. Determine whether APPLETLK.NLM was loaded successfully. Make sure that the 
  442. zone lists for AppleTalk's interfaces were initialized successfully.
  443.  
  444. 7. MACIPXGW: Bad NBP entity.
  445.  
  446. A bad NBP entity was formed for the IPX gateway when it tried to register with 
  447. NBP.
  448.  
  449. Determine whether the zone list for AppleTalk's interfaces were initialized 
  450. successfully. Also, determine whether the SYS volume is mounted because the 
  451. IPX gateway can fail to get the local server or router name required to build 
  452. its NBP name if the SYS volume is not mounted.
  453.  
  454. 8. MACIPXGW: NBP registration failed.
  455.  
  456. The gateway failed to register with NBP as <server_name>:IPX_Gateway@<zone>.
  457.  
  458. Determine whether a duplicate entity already exists on the network.
  459.  
  460. 9. MACIPXGW: Unable to open <file>.
  461.  
  462. The configuration file MACIPXGW.DAT exists in the SYS:SYSTEM directory, but 
  463. the IPX gateway is unable to open the file.
  464.  
  465. Determine whether the SYS volume is mounted. Check file access.
  466.  
  467. 10. MACIPXGW: Insufficient memory to read <file>.
  468.  
  469. There is not enough memory to read the MACIPXGW.DAT configuration file.
  470.  
  471. Unload unnecessary modules to free up memory and try reloading again.
  472.  
  473. 11. MACIPXGW: Unable to allocate ECB.
  474.  
  475. This condition usually develops because some module is tying up system 
  476. resources.
  477.  
  478. Check for such modules using the MONITOR module. If such a condition prevails, 
  479. unload unnecessary system modules to free up resources.
  480.  
  481. 12. MACIPXGW: Failed to send AppleTalk packet, error [<error code>].
  482.  
  483. The gateway may have lost its connection with AppleTalk.
  484.  
  485. If the problem persists, unload the gateway and, if necessary, APPLETLK.NLM, 
  486. and reload them again.
  487.  
  488. 13. MACIPXGW: Error [<error code>] starting timer.
  489.  
  490. There is not enough memory to start the timer.
  491.  
  492. Unload the gateway, try to free up more memory by unloading unnecessary NLMs, 
  493. and reload the gateway again.
  494.  
  495. 14. MACIPXGW: Failed to register gateway with NBP.
  496.  
  497. There may already be another NVE (network-visible entity) with the same name 
  498. on the network, or the gateway may have lost its connection to AppleTalk.
  499.  
  500. Check for a duplicate NVE on the network, and if there is a duplicated name, 
  501. change the gateway name by using the NAME parameter on the LOAD line. Then 
  502. reload. If there is no duplicated name, try unloading the gateway and, if 
  503. necessary, APPLETLK.NLM, and then reload again.
  504.  
  505. 15. MACIPXGW: Bad <entry> entry in <file>.
  506.  
  507. A bad entry is found in the configuration file MACIPXGW.DAT.
  508.  
  509. Validate the file's contents.
  510.  
  511. 16. MACIPXGW: Failed to receive AppleTalk packet, error [<error code>].
  512.  
  513. The gateway is unable to get AppleTalk packets from the AppleTalk stack 
  514. because either the gateway has lost its connection to AppleTalk or there are 
  515. not enough system resources available.
  516.  
  517. If the problem persists, unload the gateway and, if necessary, APPLETLK.NLM, 
  518. and reload again.
  519.  
  520. 17. MACIPXGW: IPX packet too big.
  521.  
  522. IPX packet size exceeds maximum specified in the protocol for encapsulating 
  523. IPX in AppleTalk.
  524.  
  525. 18. MACIPXGW: Failed to get AppleTalk information.
  526.  
  527. Determine whether APPLETLK.NLM is loaded successfully and whether its 
  528. interfaces are initialized successfully.
  529.  
  530. 19. Fatal Error: Could not allocate a memory resource tag.
  531.  
  532. There are not enough system resources.
  533.  
  534. Unload unnecessary NLMs and reload the gateway again.
  535.  
  536. 20. Fatal Error: Could not allocate an ECB resource tag.
  537.  
  538. See message number 11, further above.
  539.  
  540. 21. Failed to initialize CLIB.
  541.  
  542. There are not enough system resources.
  543.  
  544. Unload unnecessary NLMs and reload the gateway again.
  545.  
  546. 22. MACIPXGW: Gateway name truncated to 32 characters.
  547.  
  548. The gateway name that was specified with the GATEWAY_NAME parameter on the 
  549. LOAD MACIPXGW command line exceeded the 32-character limit.
  550.  
  551. 23. MACIPXGW: Gateway name must be delimited by double quotes.
  552.  
  553. The name for the gateway, specified with the GATEWAY_NAME parameter on the 
  554. LOAD MACIPXGW command line, lacks the necessary double quotes.
  555.  
  556. Either reissue a corrected command, or modify the AUTOEXEC.NCF file, or both.
  557.  
  558. 24. MACIPXGW: Incomplete command line parameter.
  559.  
  560. The LOAD MACIPXGW command contains an complete parameter.
  561.  
  562. Either reissue a corrected command, or modify the AUTOEXEC.NCF file, or both.
  563.  
  564. 25. MACIPXGW: Bad command line parameter.
  565.  
  566. The LOAD MACIPXGW command contains an invalid parameter.
  567.  
  568. Either reissue a corrected command, or modify the AUTOEXEC.NCF file, or both.
  569.  
  570. 26. MACIPXGW: Fatal error [<error code>]! MACIPXGW.LAN is no longer 
  571. functional. Please unload the module.
  572.  
  573. The gateway has encountered a problem from which it cannot recover. It has 
  574. automatically unbound itself from the IPX network and closed the DDP socket it 
  575. was using, so that it will no longer process any incoming or outgoing packets.
  576.  
  577. Unload the gateway and reload it to use it again.
  578.  
  579.  
  580. TIPS ON ADMINISTERING AN IPX GATEWAY
  581.  
  582. All IPX gateways, including those produced by Novell and those produced by 
  583. other vendors, must conform to some administrative guidelines. Here are some 
  584. tips and general information to make the job easier.
  585.  
  586.  
  587. -- Tips about Routing --
  588.  
  589. Keep these points in mind with regard to administering the routing of packets 
  590. with an IPX gateway:
  591.  
  592. * Each IPX gateway is also an IPX router and must be administered in the same 
  593. way as any other IPX router.
  594.  
  595. * Each IPX gateway always advertises itself via AppleTalk NBP, regardless of 
  596. whether it can actually process IPX packets. This allows the IPX gateway to be 
  597. located with AppleTalk network management tools. The IPX gateway is registered 
  598. with an NBP Type of "IPX Gateway."
  599.  
  600. NOTE: MacIPX clients will only find those gateways which *can* process IPX 
  601. packets. This discovery is performed using a combination of AppleTalk DDP and 
  602. NBP to produce a list of gateways that can service the MacIPX application.
  603.  
  604. * You *cannot* use MacIPX for the purpose of bridging IPX networks across an 
  605. AppleTalk internetwork. This means that you cannot use IPX gateways and their 
  606. encapsulation capabilities to connect two or more IPX networks across an 
  607. AppleTalk cloud. This is because MacIPX, its drivers, and associated utilities 
  608. are not designed as extensions to AppleTalk networking. MacIPX is designed to 
  609. enable Macintosh workstations to participate directly in IPX networks and to 
  610. encourage multi-platform peer-to-peer connectivity.
  611.  
  612.  
  613. -- Tips about Addressing --
  614.  
  615. Keep these points in mind with regard to network numbers and addresses for 
  616. nodes and clients:
  617.  
  618. * Each IPX gateway must have a unique IPX network number in the same way that 
  619. all other network interfaces in the server must have a unique network number. 
  620. Any MacIPX clients using the gateway will be on that new IPX network. Some 
  621. gateway implementations, including the IPX gateway provided with MacIPX from 
  622. Novell, may enable you to restrict the set of AppleTalk networks that the IPX 
  623. gateway can serve. (Refer to "Configuring the IPX Gateway to Serve Specific 
  624. AppleTalk Networks," earlier in this file.) Thus, the IPX network that a 
  625. MacIPX client is on will change when that client changes IPX gateways.
  626.  
  627. * Here is how the IPX address of a MacIPX client using an IPX gateway is 
  628. determined:
  629.  
  630. -- The network number is the one that has been assigned to the gateway itself 
  631. through the BIND command, and
  632.  
  633. -- The node ID consists of three bytes of leading zeros followed by the 
  634. client's two-byte AppleTalk network number (that is, the AppleTalk network 
  635. that the client is on) and the client's one-byte AppleTalk node ID.
  636.  
  637. For example, if the MacIPX client on AppleTalk network 0x1234 with node ID 
  638. 0xAA is using a gateway whose IPX network is 0xFEEDFACE, then the IPX address 
  639. of the client (hex) is FEEDFACE:0000001234AA.
  640.  
  641. * The DDP socket 0x4E is used on the MacIPX client to communicate with the IPX 
  642. gateway.
  643.  
  644.  
  645. -- Tips about Performance and Network Traffic --
  646.  
  647. Keep this point in mind with regard to broadcast data packets and network 
  648. traffic:
  649.  
  650. * A "broadcast" IPX packet may be forwarded as a *broadcast* data link packet 
  651. onto all the AppleTalk networks that an IPX gateway serves. In this case, all 
  652. nodes on an AppleTalk network that has at least one MacIPX client on it will 
  653. receive the IPX packet. Alternatively, the "broadcast" IPX packet may be 
  654. forwarded as a *unicast* data link packet to each MacIPX client using the IPX 
  655. gateway.
  656.  
  657. This feature enables you to decide whether some clients may receive 
  658. "unnecessary" packets (that is, "broadcast" IPX packets may be sent to 
  659. AppleTalk end nodes that are not MacIPX clients) or whether network traffic 
  660. may be increased because of the greater number of packets being sent. This is 
  661. because a single "broadcast" IPX packet could become a large number of unicast 
  662. packets, thereby increasing the network load. We do not currently recommend 
  663. one strategy over the other, but we do recommend that you refer to "Delivering 
  664. IPX Broadcast Messages on AppleTalk Networks," further above in this file, for 
  665. operational details on how to implement the preferred strategy.
  666.  
  667. NOTE: Some gateway implementations may provide this feature; that is, the 
  668. gateway may always send broadcast packets or it may always send unicast 
  669. packets, or some combination thereof.
  670.  
  671.  
  672. KNOWN ANOMALIES IN THE IPX GATEWAY (VERSION 1.01)
  673.  
  674. PROBLEM: The IPX gateway (MACIPXGW.LAN) may fail to load on a NetWare 4.0 
  675. server whose APPLETLK.NLM is configured in the following manner: Routing is 
  676. enabled, the internal net is removed, and seed net and zone information are 
  677. derived from the network.
  678.  
  679. SOLUTION: You can work around this problem by changing the configuration of 
  680. the APPLETLK.NLM (for example, you could explicitly specify the net and zone 
  681. information for the interface that the AppleTalk stack is homed on). For more 
  682. information about APPLETLK.NLM configuration, please refer to the NetWare for 
  683. Macintosh Installation and Maintenance manual for NetWare for Macintosh 4.0 
  684. (Novell Part # 100-001795-001).
  685.  
  686.  
  687. TRADEMARKS
  688.  
  689. Novell and NetWare are registered trademarks, NetWire is a service mark, and 
  690. MacIPX, IPX, and NetWare Multiprotocol Router are trademarks, of Novell, Inc.
  691.  
  692. Macintosh and AppleTalk are registered trademarks of Apple Computer, Inc.
  693.  
  694. CompuServe is a registered trademark of CompuServe Incorporated.
  695.